home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / macros / latex209 / contrib / custom-bib / readme.2 < prev    next >
Text File  |  1994-04-21  |  5KB  |  104 lines
  1.                               CUSTOM-BIB Package
  2.  
  3. (Now includes support for other languages.)
  4.  
  5. This is the custom-bib package for generating customized BibTeX bibliography
  6. styles from a generic file by means of Frank Mittelbach's docstrip program.
  7.  
  8. The package contains the following files:
  9.   genbst.mbs   --  A master BibTeX style file for producing customized
  10.                    styles (numerical or author-year) with docstrip. It is
  11.                    self-documenting: simply latex it to produce its
  12.                    description (requires doc.sty).
  13.  
  14.                    This is version 1.2, replacing 1.0. A problem with 
  15.                    harvard.bst has been fixed up, and there is a new option
  16.                    to allow thesis titles to be formatted the same as
  17.                    articles, rather than as books.
  18.                    
  19.   babel.mbs    --  A variation of genbst.mbs for multilingual support. It
  20.                    can produce .bst files for English, French, German,
  21.                    Esperanto, and is extendable. Alternatively, one selects
  22.                    the `language' babel, and the language-specific words are
  23.                    replaced by commands that need to be defined in a separate
  24.                    input file. This file is automatically read in by the .bbl
  25.                    file.
  26.  
  27.   xbtxbst.mbs  --  The master bib style file used by Oren Patashnik (with
  28.                    minor additions by others) for C Preprocessor (XBTXBST.DOC)
  29.                    converted to the docstrip scheme here, with all original
  30.                    comments put into LaTeX format. LaTeXing this file produces
  31.                    the documentation of the original Patashnik text. 
  32.                    
  33.   makebst.doc  --  the documented `program' to select interactively the
  34.                    docstrip options for one of the *.mbs files, using
  35.                    information in the .mbs file itself.
  36.                    
  37.   makebst.ins  --  a docstrip batch job to extract from makebst.doc the files
  38.                    makebst.tex (decommented version of the program) and 
  39.                    mkbst.tex (a driver to produce documentation from
  40.                    makebst.doc, requires doc.sty)
  41.  
  42. Many authors are frustrated at the wide range of bibliographic styles demanded
  43. by journals and publishers, and at the limited number available with standard
  44. LaTeX and BibTeX. This is not the fault of the latter, but rather of the lack
  45. of any bibliographic standards in the English language. Often the differences
  46. are so trivial (comma or colon, date in brackets or parentheses). The normal
  47. user does not want to tackle the task of making up his own .bst file (no
  48. normal human would!) 
  49.  
  50. For this reason, I set out to produce a generic .bst file that could have
  51. features and options selected by means of Mittelbach's docstrip program. 
  52. I found over 50 different *.bst files and compared their outputs just for
  53. article: they were all different. They served as part of my input as to what
  54. features were needed. I knew of a few extra that were not covered by these 50.
  55.  
  56. I also discovered XBTXBST.DOC, a minor modification of Patashnik's BTXBST.DOC,
  57. as well as a file PHYSICS.BST, all of which are meant to do precisely what I
  58. had set up to accomplish. However, they make use of the C Preprocessor
  59. language. It is really a simple matter to convert the preprocessor commands
  60. into docstrip equivalents. 
  61.  
  62. Nevertheless, none of these really met all of my needs, so I continued to
  63. develop GENBST.mbs (GENeric-BibST.MasterBibSt). It soon became obvious that the
  64. sheer number of options necessary made any kind of customizing a difficult
  65. chore. Hence, the next step: the program MAKEBST takes menu information from
  66. the selected .mbs file and presents the user with descriptive choices as
  67. menus. From the answers, it writes a docstrip batch job (extension .drv) which
  68. when TeX'ed, creates the desired .bst file out of the .mbs one. The .drv file
  69. may even be hand edited if one wants to alter only one or two options.
  70.  
  71. To use the package: (I assume you have docstrip.tex and doc.sty; if you do not
  72.   have the former, then you cannot use the package anyway; they are to be found
  73.   under /macros/latex/distrib/doc)
  74.  
  75. 1. run TeX (or LaTeX) on makebst.ins (--> makebst.tex and mkbst.tex)
  76. 2. LaTeX mkbst.tex  to get the documentation for makebst
  77. 3. run TeX (or LaTeX) on makebst.tex (or makebst.doc) to start customizing
  78.      your own .bst file. You may select the master file as either genbst,
  79.      babel, or xbtxdoc.
  80.      
  81. For documentation on the master bib files, just LaTeX genbst.mbs, babel.mbs
  82. or xbtxbst.mbs themselves. (Note, xbtxbst.mbs will also output the Patashnik
  83. comments to the coding. I have not yet managed to do this for genbst.mbs)
  84.  
  85. NOTE ON AUTHOR-YEAR CITATIONS:-
  86. Author-year style citations are not supported by standard LaTeX and BibTeX.
  87. However, there exist a large number of bib styles for this, all of which need
  88. some style interface to run properly. I have identified 5 different style
  89. interfaces, plus a 6th one that I use myself (see the NATBIB package in a
  90. parallel directory). I have made up genbst.mbs to be able to produce .bst
  91. files for all 6. If one selects author-year style, then one is asked which
  92. style interface is to be used. (Incidentally my natbib.sty is capable of
  93. reading all 6).
  94.  
  95. 1994 February 14
  96. Patrick W. Daly
  97. Max-Planck-Institut f\"ur Aeronomie
  98. D-37189 Katlenburg-Lindau, Germany
  99. E-mail:
  100. Internet-- daly@linax1.dnet.gwdg.de
  101.  
  102.   
  103.   
  104.